home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 February / EnigmA AMIGA RUN 34 (1999)(G.R. Edizioni)(IT)[!][issue 1999-02].iso / earcd / -recent3 / wblaunch.readme < prev    next >
Text File  |  1999-01-01  |  4KB  |  137 lines
  1. Short:    Simulate WB startup from Shell
  2. Author:   Stephen Williams <sw@fysh.org>
  3. Uploader: Stephen Williams <sw@fysh.org>
  4. Version:  1.1
  5. Type:     util/cli
  6. Requires: AmigaOS 3.0+, util/libs/WBStart.lha
  7. Replaces: util/cli/WBLaunch.lha
  8.  
  9.  
  10. =============================================
  11. WBLaunch 1.1, (c) 1998, 1999 Stephen Williams
  12. =============================================
  13.  
  14.  
  15. 1. What is it?
  16. 2. What do I need to use it?
  17. 3. How do I use it?
  18. 4. Acknowledgements
  19. 5. Legal
  20. 6. Changes
  21. 7. The author
  22.  
  23.  
  24. 1. What is it?
  25. --------------
  26.  
  27. WBLaunch is a program whose sole aim in life is to launch other
  28. programs from the Shell, simulating Workbench startup.  It does this
  29. with the aid of Stefan Becker's excellent wbstart.library.
  30.  
  31.  
  32. 2. What do I need to use it?
  33. ----------------------------
  34.  
  35. You need AmigaOS release 3.0 or above.  wbstart.library requires this
  36. OS, so I made WBLaunch check for release 3.0 and refuse to start if it
  37. isn't present.  You will also need wbstart.library release 2.0 or
  38. greater, a copy of which can be got from Aminet (util/libs/WBStart.lha).
  39.  
  40.  
  41. 3. How do I use it?
  42. -------------------
  43.  
  44. Copy WBLaunch into your C directory.  If your dearchiver junked the
  45. protection bits, then do
  46.   protect c:WBLaunch prwed
  47.  
  48. WBLaunch may, of course, be used only from the Shell ;-)
  49.  
  50. WBLaunch expects arguments according to the following template:
  51.   PROGRAM/A,ARGS/M,VERBOSE/S,PRI=PRIORITY/N/K
  52.  
  53. PROGRAM is the name of the program you want to launch.  WBLaunch will
  54. search your path for this; alternatively, you may specify a full
  55. pathname.  For example:
  56.   WBLaunch sys:Utilities/Clock
  57.   WBLaunch Clock
  58.  
  59. ARGS are the arguments you want to pass.  From Workbench, you'd do
  60. this by holding SHIFT and clicking in turn on the icons of the files
  61. you want to pass as arguments.  WBLaunch will attempt to Lock() each
  62. of the arguments you pass, and will only pass on arguments which can
  63. be successfully Lock()ed.
  64.  
  65. If you specify the VERBOSE switch, WBLaunch will tell you the full
  66. path of the program which it has launched, and the arguments which
  67. have been specified.
  68.  
  69. The PRI argument may be used to specify a priority for the process to
  70. be started, for example
  71.   WBLaunch CPUThrasher pri=-10
  72.  
  73. Once the Workbench process has been started, WBLaunch will return -
  74. there's no need to run it in the background.
  75.  
  76. I recommend that you place a line like this in your User-Startup:
  77.   Resident name=WB c:WBLaunch
  78. If you do this, you can simulate starting a program from Workbench
  79. simply by prefixing its name with "wb".
  80.  
  81. Don't use WBLaunch to start Format or DiskCopy.  On my machine, it
  82. barfs.  I haven't got a clue why.  Mind you, I haven't got a clue
  83. why you'd want to use WBLaunch to start Format or DiskCopy in the
  84. first place ;-)
  85.  
  86.  
  87. 4. Acknowledgements
  88. -------------------
  89.  
  90. wbstart.library is (c) 1991-1996 by Stefan Becker.
  91.  
  92.  
  93. 5. Legal
  94. --------
  95.  
  96. WBLaunch 1.1 is distributed as open source software under the terms of
  97. the GNU General Public Licence (GPL).  You should have received a copy
  98. of the GPL along with this program; the file should have been named
  99. "COPYING".  If you did not receive it, you can obtain a copy by
  100. writing to the Free Software Foundation, Inc., 675 Mass Ave,
  101. Cambridge, MA 02139, USA.
  102.  
  103. The GPL permits modification of this program, and distribution of the
  104. modified copy, provided the source code is included.  If you do decide
  105. to do this, I request that you indicate this in the version number of
  106. your modified copy.  For example, if you name is John Smith, and your
  107. version is based on WBLaunch 1.1, you might call your version
  108. "WBLaunch 1.1js1".  This will help distinguish modified WBLaunches
  109. from the original, without removing your rights to derive new works
  110. from the original source.  This request complies with clause 2a of the
  111. GPL.
  112.  
  113. Please send me any modifications you make; I might want to include
  114. them in the next "official" release of WBLaunch.
  115.  
  116.  
  117. 6. Changes
  118. ----------
  119.  
  120. Version 1.0 (July 7, 1998):
  121. - Initial release.
  122.  
  123. Version 1.1 (February 14, 1999):
  124. - Fixed a bug; WBLaunch was unable to find programs if the path was
  125.   specified relative to the current directory;
  126. - WBLaunch is now open source, released under the terms of the GNU
  127.   General Public Licence.
  128.  
  129.  
  130. 7.  The author
  131. --------------
  132.  
  133. Stephen Williams, sw@fysh.org, http://www.nysa.u-net.com/
  134.  
  135. Check out http://www.nysa.u-net.com/software/ for other programs
  136. by me.
  137.